/**
 * Converts a single boolean value.
 *
 * First converts the value to its native PHP boolean type
 * and passes it to the given callback function to be reconverted
 * into any custom representation.
 *
 * @param mixed    $value    The value to convert.
 * @param callable $callback The callback function to use for converting the real boolean value.
 *
 * @return mixed
 */
private function convertSingleBooleanValue($value, $callback)
{
    if (null === $value) {
        return $callback(false);
    }

    if (is_bool($value) || is_numeric($value)) {
        return $callback($value ? true : false);
    }

    if (is_string($value) && in_array(trim(strtolower($value)), $this->booleanLiterals['false'])) {
        return $callback(false);
    }

    return $callback(true);
}

/**
 * Converts one or multiple boolean values.
 *
 * First converts the value(s) to their native PHP boolean type
 * and passes them to the given callback function to be reconverted
 * into any custom representation.
 *
 * @param  $item     The value(s) to convert.
 * @param  $callback The callback function to use for converting the real boolean value(s).
 *
 * @return mixed
 */
private function doConvertBooleans($item, $callback)
{
    if (is_array($item)) {
        foreach ($item as $key => $value) {
            $item[$key] = $this->convertSingleBooleanValue($value, $callback);
        }

        return $item;
    }

    return $this->convertSingleBooleanValue($item, $callback);
}

/**
 * {@inheritdoc}
 */
public function convertBooleans($item)
{
    if ( ! $this->useBooleanTrueFalseStrings) {
        return parent::convertBooleans($item);
    }

    return $this->doConvertBooleans(
        $item,
        function ($boolean) {
            return true === $boolean ? 'true' : 'false';
        }
    );
}

/**
 * {@inheritdoc}
 */
public function convertBooleansToDatabaseValue($item)
{
    if ( ! $this->useBooleanTrueFalseStrings) {
        return parent::convertBooleansToDatabaseValue($item);
    }

    return $this->doConvertBooleans(
        $item,
        function ($boolean) {
            return (int) $boolean;
        }
    );
}